stof/README.md

## README.md

      
    Raw
  

              README.md
            
          
    Using d3plus.textwrap, SVG <text> elements can be broken into separate <tspan> lines, as HTML does with <div> elements. In this example, the first column shows normal wrapped text, the second column shows text that is resized to fill the available space, and the third column shows the default SVG behavior.
D3plus automatically detects if there is a <rect> or <circle> element placed directly before the <text> container element in DOM, and uses that element's shape and dimensions to wrap the text. If it can't find one, or that behavior needs to be overridden, they can manually be specified using .shape( ), .width( ), and .height( ).
Featured on D3plus.org

  
## index.html
<!DOCTYPE html>
<meta charset="utf-8">

<script src="https://cdn.jsdelivr.net/npm/d3@7"></script>
<script src="https://cdn.jsdelivr.net/npm/d3plus@1"></script>

<style>

  svg {
    font-family: "Helvetica", "Arial", sans-serif;
    height: 425px;
    margin: 25px;
    width: 900px;
  }

  .type {
    fill: #888;
    text-anchor: middle;
  }

  .shape {
    fill: #eee;
    stroke: #ccc;
  }

</style>

<svg>

  <!-- Text that will use the D3plus default wrapping. -->
  <text class="type" dy="15px" x="75px">Wrapped</text>

  <rect class="shape" height="150px" width="150px" y="50px"></rect>
  <text id="rectWrap" class="wrap" y="50px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

  <circle class="shape" r="75px" cx="75px" cy="300px"></circle>
  <text id="circleWrap" class="wrap" y="225px" x="0px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

  <!-- Text that D3plus will resize to fit the available space. -->
  <text class="type" dy="15px" x="275px">Resized</text>

  <rect class="shape" height="150px" width="150px" y="50px" x="200px"></rect>
  <text id="rectResize" class="wrap" y="50px" x="200px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

  <circle class="shape" r="75px" cx="275px" cy="300px"></circle>
  <text id="circleResize" class="wrap" y="225px" x="200px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

  <!-- For comparison, how SVG would display the text without D3plus. -->
  <text class="type" dy="15px" x="475px">Default Behavior</text>

  <rect class="shape" height="150px" width="150px" y="50px" x="400px"></rect>
  <text class="wrap" y="50px" x="400px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

  <circle class="shape" r="75px" cx="475px" cy="300px"></circle>
  <text class="wrap" y="225px" x="400px" font-size="12">
    Here is a long text string that SVG should wrap by default, but it does not.
  </text>

</svg>

<script>

  // Wrap text in a rectangle.
  d3plus.textwrap()
    .container(d3.select("#rectWrap"))
    .draw();

  // Wrap text in a rectangle, and size the text to fit.
  d3plus.textwrap()
    .container(d3.select("#rectResize"))
    .resize(true)
    .draw();

  // Wrap text in a circle.
  d3plus.textwrap()
    .container(d3.select("#circleWrap"))
    .draw();

  // Wrap text in a circle, and size the text to fit.
  d3plus.textwrap()
    .container(d3.select("#circleResize"))
    .resize(true)
    .draw();

</script>

## thumbnail.png

      
    Raw
  

              thumbnail.png
	<!DOCTYPE html>
	<meta charset="utf-8">

	<script src="https://cdn.jsdelivr.net/npm/d3@7"></script>
	<script src="https://cdn.jsdelivr.net/npm/d3plus@1"></script>

	<style>

	svg {
	font-family: "Helvetica", "Arial", sans-serif;
	height: 425px;
	margin: 25px;
	width: 900px;
	}

	.type {
	fill: #888;
	text-anchor: middle;
	}

	.shape {
	fill: #eee;
	stroke: #ccc;
	}

	</style>

	<svg>

	<!-- Text that will use the D3plus default wrapping. -->
	<text class="type" dy="15px" x="75px">Wrapped</text>

	<rect class="shape" height="150px" width="150px" y="50px"></rect>
	<text id="rectWrap" class="wrap" y="50px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	<circle class="shape" r="75px" cx="75px" cy="300px"></circle>
	<text id="circleWrap" class="wrap" y="225px" x="0px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	<!-- Text that D3plus will resize to fit the available space. -->
	<text class="type" dy="15px" x="275px">Resized</text>

	<rect class="shape" height="150px" width="150px" y="50px" x="200px"></rect>
	<text id="rectResize" class="wrap" y="50px" x="200px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	<circle class="shape" r="75px" cx="275px" cy="300px"></circle>
	<text id="circleResize" class="wrap" y="225px" x="200px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	<!-- For comparison, how SVG would display the text without D3plus. -->
	<text class="type" dy="15px" x="475px">Default Behavior</text>

	<rect class="shape" height="150px" width="150px" y="50px" x="400px"></rect>
	<text class="wrap" y="50px" x="400px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	<circle class="shape" r="75px" cx="475px" cy="300px"></circle>
	<text class="wrap" y="225px" x="400px" font-size="12">
	Here is a long text string that SVG should wrap by default, but it does not.
	</text>

	</svg>

	<script>

	// Wrap text in a rectangle.
	d3plus.textwrap()
	.container(d3.select("#rectWrap"))
	.draw();

	// Wrap text in a rectangle, and size the text to fit.
	d3plus.textwrap()
	.container(d3.select("#rectResize"))
	.resize(true)
	.draw();

	// Wrap text in a circle.
	d3plus.textwrap()
	.container(d3.select("#circleWrap"))
	.draw();

	// Wrap text in a circle, and size the text to fit.
	d3plus.textwrap()
	.container(d3.select("#circleResize"))
	.resize(true)
	.draw();

	</script>