ElementTile

ElementTile.svelte automatically changes text color to ensure high contrast with its background. If its background is transparent, it traverses up the DOM tree to find the first element with non-transparent background color. This can, of course, go wrong e.g. if the tile is absolutely positioned outside its parent element. In that case, pass an explicit text_color prop and luminance_threshold={null} to ElementTile to override the automatic color selection.

    1 H Hydrogen
    2 He Helium
    3 Li Lithium
    4 Be Beryllium
    5 B Boron
    6 C Carbon
    7 N Nitrogen
    8 O Oxygen
    9 F Fluorine
    10 Ne Neon
    11 Na Sodium
    12 Mg Magnesium
    13 Al Aluminium
    14 Si Silicon
    15 P Phosphorus
    16 S Sulfur
    17 Cl Chlorine
    18 Ar Argon
    19 K Potassium
    20 Ca Calcium
    21 Sc Scandium
    22 Ti Titanium
    23 V Vanadium
    24 Cr Chromium
    25 Mn Manganese
    26 Fe Iron
    27 Co Cobalt 
svelte<script lang="ts">
  import { element_data, ElementTile } from 'matterviz'

  const rand_color = () =>
    `hsl(${Math.random() * 360}, ${Math.random() * 50 + 50}%, ${
      Math.random() * 50 + 50
    }%)`
</script>

<ol>
  {#each Array(27).fill(0).map((_, idx) => ({
      bg_color: rand_color(),
      element: element_data[idx],
    })) as
    { bg_color, element }
    (element.symbol)
  }
    <ElementTile {bg_color} {element} style="width: 4em; margin: 0" />
  {/each}
</ol>

<style>
  ol {
    display: flex;
    flex-wrap: wrap;
    gap: 1em;
  }
</style>

Displaying values instead of element names by passing the value prop.

    1 H 0.872
    2 He 0.101
    3 Li 0.549
    4 Be 0.2
    5 B 0.609
    6 C 0.15
    7 N 0.031
    8 O 0.695 
svelte<script lang="ts">
  import { element_data, ElementTile } from 'matterviz'

  const bg_colors = `red green blue yellow cyan magenta black white`.split(` `)
</script>

<ol>
  {#each bg_colors as bg_color, idx (bg_color)}
    <ElementTile
      {bg_color}
      element={element_data[idx]}
      value={Math.random()}
      style="width: 4em; margin: 0"
      active
    />
  {/each}
</ol>

<style>
  ol {
    display: flex;
    flex-wrap: wrap;
    gap: 1em;
  }
</style>

Multi-value Split Layouts

ElementTile supports displaying multiple values per tile with different split layout options. Control the layout using the split_layout prop.

Auto-determined Layouts

When split_layout is not specified, the layout is automatically chosen based on the number of values.

H 1.22.5
He 1.22.50.8
Li 1.22.50.83.1

Explicit Layout Control

Be 1.22.50.8
B 1.22.50.8
C 1.22.50.83.1
N 1.22.50.83.1 
svelte<script lang="ts">
  import { element_data, ElementTile } from 'matterviz'

  const values = {
    two: [1.2, 2.5],
    three: [1.2, 2.5, 0.8],
    four: [1.2, 2.5, 0.8, 3.1],
  }
  const colors = ['#ff6b6b', '#4ecdc4', '#45b7d1', '#f9ca24']
  const tile_style = 'width: 5em; height: 5em;'
</script>

<h4>Auto-determined Layouts</h4>
<p>
  When <code>split_layout</code> is not specified, the layout is automatically chosen
  based on the number of values.
</p>
<div class="examples">
  <ElementTile
    element={element_data[0]}
    value={values.two}
    bg_colors={colors.slice(0, 2)}
    style={tile_style}
  />
  <ElementTile
    element={element_data[1]}
    value={values.three}
    bg_colors={colors.slice(0, 3)}
    style={tile_style}
  />
  <ElementTile
    element={element_data[2]}
    value={values.four}
    bg_colors={colors}
    style={tile_style}
  />
</div>

<h4>Explicit Layout Control</h4>
<div class="examples">
  <!-- 3 values: horizontal vs vertical -->
  <ElementTile
    element={element_data[3]}
    value={values.three}
    bg_colors={colors.slice(0, 3)}
    split_layout="horizontal"
    style={tile_style}
  />
  <ElementTile
    element={element_data[4]}
    value={values.three}
    bg_colors={colors.slice(0, 3)}
    split_layout="vertical"
    style={tile_style}
  />

  <!-- 4 values: triangular vs quadrant -->
  <ElementTile
    element={element_data[5]}
    value={values.four}
    bg_colors={colors}
    split_layout="triangular"
    style={tile_style}
  />
  <ElementTile
    element={element_data[6]}
    value={values.four}
    bg_colors={colors}
    split_layout="quadrant"
    style={tile_style}
  />
</div>

<style>
  .examples {
    display: flex;
    gap: 1.5em;
    align-items: center;
    margin: 2em 0;
    flex-wrap: wrap;
  }
</style>

Note: The atomic number is automatically hidden for multi-value splits to prevent overlap with value labels. You can override this behavior with the show_number prop.