What happens to an item already longer than the target width?

It's left completely unchanged. Padding only ever adds characters to reach the target width; it never truncates an item that's already at or beyond that width.

Can I use any fill character?

Any single character works, common choices are a space for text alignment or "0" for numeric zero-padding.

How is this different from List Right-Padder?

This tool adds fill characters before each item (left padding, via padStart); List Right-Padder adds them after each item instead (right padding, via padEnd).

Does this remove leading whitespace or characters that are already there?

No, it only adds fill characters when an item is shorter than the target width; existing content is never removed.

List Left-Padder - Pad List Items to a Fixed Width

Overview

Introduction

Lists of values naturally come in varying lengths, which can make them hard to scan or feed into a system that expects a fixed-width field.

List Left-Padder adds fill characters to the left of every item in a list so they all reach the same target width, without changing their content.

What Is List Left-Padder?

This is a per-item formatting tool: it walks every item in a list and, for each one shorter than your target width, adds fill characters on the left until it reaches that width.

It never removes characters and never affects an item longer than the target, only shorter items are extended.

How List Left-Padder Works

The list is split into items using your chosen separator, then each item is passed through `String.prototype.padStart(width, fillChar)`.

Items already at or longer than the target width pass through completely untouched; only shorter items gain leading fill characters.

When To Use List Left-Padder

Use this whenever you need a column of values to line up visually or fit a fixed-width field, like formatting IDs, numbers, or codes for a report.

It's a natural pairing with List Right-Padder when different columns need different alignment.

Often used alongside List Right-Padder, List Item Trimmer and List Truncator.

Features

Advantages

Never changes an item's actual content, only adds fill characters to reach the target width.
Safe on mixed-length lists, items already wide enough are left untouched rather than causing an error.
Works with any single-character fill and any separator style.

Limitations

Only pads on the left; use List Right-Padder for the opposite direction.
Fill must be exactly one character; multi-character fills aren't supported.

Examples

Zero-padding a mixed-length numeric list

Input

1, 22, 333 (width: 4, fill: "0")

Output

0001, 0022, 0333

Each item gains exactly as many leading zeros as it needs to reach 4 characters.

Space-padding for column alignment

Input

a, bb (width: 3, fill: " ")

Output

  a,   bb

Each item is right-aligned within a 3-character column using leading spaces.

Best Practices & Notes

Best Practices

Use "0" as the fill for numeric IDs or codes, and a space for general text alignment.
Pick a target width based on your longest expected item so nothing needs padding beyond what you intend.

Developer Notes

Each item is passed through JavaScript's built-in `String.prototype.padStart(width, fillChar)`, which is a no-op when the string is already at or beyond the target length.

List Left-Padder Use Cases

Zero-padding a list of numeric IDs to a consistent width
Right-aligning a column of values for a readable report
Preparing fixed-width fields for a downstream file format or API

Common Mistakes

Expecting padding to truncate items longer than the target width; it doesn't, by design, it only ever adds characters.
Trying to use a multi-character fill string, which the tool rejects since padStart expects the pattern to repeat character by character.

Tips

If you want every item visually the same width regardless of its own length, pick a width at least as large as your longest expected item.
Combine with List Item Trimmer first if stray whitespace is throwing off your item widths.

List Left-Padder