Pen Settings

HTML

CSS

CSS Base

Vendor Prefixing

Add External Stylesheets/Pens

Any URLs added here will be added as <link>s in order, and before the CSS in the editor. You can use the CSS from another Pen by using its URL and the proper URL extension.

+ add another resource

JavaScript

Babel includes JSX processing.

Add External Scripts/Pens

Any URL's added here will be added as <script>s in order, and run before the JavaScript in the editor. You can use the URL of any other Pen and it will include the JavaScript from that Pen.

+ add another resource

Packages

Add Packages

Search for and use JavaScript packages from npm here. By selecting a package, an import statement will be added to the top of the JavaScript editor for this package.

Behavior

Auto Save

If active, Pens will autosave every 30 seconds after being saved once.

Auto-Updating Preview

If enabled, the preview panel updates automatically as you code. If disabled, use the "Run" button to update.

Format on Save

If enabled, your code will be formatted when you actively save your Pen. Note: your code becomes un-folded during formatting.

Editor Settings

Code Indentation

Want to change your Syntax Highlighting theme, Fonts and more?

Visit your global Editor Settings.

HTML

              
                <h1>Address and postcode lookup demo using Postcoder</h1>
<form>
  <fieldset>
    <label for="apikey">API key | Not got one? <a href="https://postcoder.com/sign-up" target="_blank">Start a free Postcoder trial</a> or use the limited demo API key: PCW45-12345-12345-1234X</label>
    <input type="text" id="apikey" value="PCW45-12345-12345-1234X" />
    <label for="txt_country">Country</label>
    <select id="txt_country">
      <option value="AF">Afghanistan</option>
      <option value="AX">Aland Islands</option>
      <option value="AL">Albania</option>
      <option value="DZ">Algeria</option>
      <option value="AS">American Samoa</option>
      <option value="AD">Andorra</option>
      <option value="AO">Angola</option>
      <option value="AI">Anguilla</option>
      <option value="AQ">Antarctica</option>
      <option value="AG">Antigua and Barbuda</option>
      <option value="AR">Argentina</option>
      <option value="AM">Armenia</option>
      <option value="AW">Aruba</option>
      <option value="AU">Australia</option>
      <option value="AT">Austria</option>
      <option value="AZ">Azerbaijan</option>
      <option value="BS">Bahamas</option>
      <option value="BH">Bahrain</option>
      <option value="BD">Bangladesh</option>
      <option value="BB">Barbados</option>
      <option value="BY">Belarus</option>
      <option value="BE">Belgium</option>
      <option value="BZ">Belize</option>
      <option value="BJ">Benin</option>
      <option value="BM">Bermuda</option>
      <option value="BT">Bhutan</option>
      <option value="BO">Bolivia</option>
      <option value="BQ">Bonaire, Sint Eustatius And Saba</option>
      <option value="BA">Bosnia and Herzegovina</option>
      <option value="BW">Botswana</option>
      <option value="BV">Bouvet Island</option>
      <option value="IO">Br. Indian Ocean Ter.</option>
      <option value="BR">Brazil</option>
      <option value="BN">Brunei Darussalam</option>
      <option value="BG">Bulgaria</option>
      <option value="BF">Burkina Faso</option>
      <option value="BI">Burundi</option>
      <option value="KH">Cambodia</option>
      <option value="CM">Cameroon</option>
      <option value="CA">Canada</option>
      <option value="CV">Cape Verde</option>
      <option value="KY">Cayman Islands</option>
      <option value="CF">Central African Rep.</option>
      <option value="TD">Chad</option>
      <option value="CL">Chile</option>
      <option value="CN">China</option>
      <option value="CX">Christmas Island</option>
      <option value="CC">Cocos (Keeling) Islands</option>
      <option value="CO">Colombia</option>
      <option value="KM">Comoros</option>
      <option value="CD">Congo (Dem. Rep.)</option>
      <option value="CG">Congo (Rep.)</option>
      <option value="CK">Cook Islands</option>
      <option value="CR">Costa Rica</option>
      <option value="CI">Côte d'Ivoire</option>
      <option value="HR">Croatia</option>
      <option value="CU">Cuba</option>
      <option value="CW">Curacao</option>
      <option value="CY">Cyprus</option>
      <option value="CZ">Czech Republic</option>
      <option value="DK">Denmark</option>
      <option value="DJ">Djibouti</option>
      <option value="DM">Dominica</option>
      <option value="DO">Dominican Republic</option>
      <option value="EC">Ecuador</option>
      <option value="EG">Egypt</option>
      <option value="SV">El Salvador</option>
      <option value="GQ">Equatorial Guinea</option>
      <option value="ER">Eritrea</option>
      <option value="EE">Estonia</option>
      <option value="ET">Ethiopia</option>
      <option value="FK">Falkland Is. (Malvinas)</option>
      <option value="FO">Faröe Islands</option>
      <option value="FJ">Fiji</option>
      <option value="FI">Finland</option>
      <option value="FR">France</option>
      <option value="GF">French Guiana</option>
      <option value="PF">French Polynesia</option>
      <option value="TF">French Southern Territories</option>
      <option value="GA">Gabon</option>
      <option value="GM">Gambia</option>
      <option value="GE">Georgia</option>
      <option value="DE">Germany</option>
      <option value="GH">Ghana</option>
      <option value="GI">Gibraltar</option>
      <option value="GR">Greece</option>
      <option value="GL">Greenland</option>
      <option value="GD">Grenada</option>
      <option value="GP">Guadeloupe</option>
      <option value="GU">Guam</option>
      <option value="GT">Guatemala</option>
      <option value="GG">Guernsey</option>
      <option value="GN">Guinea</option>
      <option value="GW">Guinea-Bissau</option>
      <option value="GY">Guyana</option>
      <option value="HT">Haiti</option>
      <option value="HM">Heard Island and McDonald Islands</option>
      <option value="HN">Honduras</option>
      <option value="HK">Hong Kong</option>
      <option value="HU">Hungary</option>
      <option value="IS">Iceland</option>
      <option value="IN">India</option>
      <option value="ID">Indonesia</option>
      <option value="IR">Iran</option>
      <option value="IQ">Iraq</option>
      <option value="IE">Ireland</option>
      <option value="IM">Isle of Man</option>
      <option value="IL">Israel</option>
      <option value="IT">Italy</option>
      <option value="JM">Jamaica</option>
      <option value="JP">Japan</option>
      <option value="JE">Jersey</option>
      <option value="JO">Jordan</option>
      <option value="KZ">Kazakhstan</option>
      <option value="KE">Kenya</option>
      <option value="KI">Kiribati</option>
      <option value="KP">Korea (Dem. Rep.)</option>
      <option value="KR">Korea (Rep.)</option>
      <option value="KW">Kuwait</option>
      <option value="KG">Kyrgyzstan</option>
      <option value="LA">Laos</option>
      <option value="LV">Latvia</option>
      <option value="LB">Lebanon</option>
      <option value="LS">Lesotho</option>
      <option value="LR">Liberia</option>
      <option value="LY">Libya</option>
      <option value="LI">Liechtenstein</option>
      <option value="LT">Lithuania</option>
      <option value="LU">Luxembourg</option>
      <option value="MO">Macao</option>
      <option value="MK">Macedonia, TFYR</option>
      <option value="MG">Madagascar</option>
      <option value="MW">Malawi</option>
      <option value="MY">Malaysia</option>
      <option value="MV">Maldives</option>
      <option value="ML">Mali</option>
      <option value="MT">Malta</option>
      <option value="MH">Marshall Islands</option>
      <option value="MQ">Martinique</option>
      <option value="MR">Mauritania</option>
      <option value="MU">Mauritius</option>
      <option value="YT">Mayotte</option>
      <option value="MX">Mexico</option>
      <option value="FM">Micronesia</option>
      <option value="MD">Moldova</option>
      <option value="MC">Monaco</option>
      <option value="MN">Mongolia</option>
      <option value="ME">Montenegro</option>
      <option value="MS">Montserrat</option>
      <option value="MA">Morocco</option>
      <option value="MZ">Mozambique</option>
      <option value="MM">Myanmar</option>
      <option value="NA">Namibia</option>
      <option value="NR">Nauru</option>
      <option value="NP">Nepal</option>
      <option value="NL">Netherlands</option>
      <option value="NC">New Caledonia</option>
      <option value="NZ">New Zealand</option>
      <option value="NI">Nicaragua</option>
      <option value="NE">Niger</option>
      <option value="NG">Nigeria</option>
      <option value="NU">Niue</option>
      <option value="NF">Norfolk Island</option>
      <option value="MP">Northern Mariana Islands</option>
      <option value="NO">Norway</option>
      <option value="OM">Oman</option>
      <option value="PK">Pakistan</option>
      <option value="PW">Palau</option>
      <option value="PS">Palestinian Territory</option>
      <option value="PA">Panama</option>
      <option value="PG">Papua New Guinea</option>
      <option value="PY">Paraguay</option>
      <option value="PE">Peru</option>
      <option value="PH">Philippines</option>
      <option value="PN">Pitcairn</option>
      <option value="PL">Poland</option>
      <option value="PT">Portugal</option>
      <option value="PR">Puerto Rico</option>
      <option value="QA">Qatar</option>
      <option value="RE">Réunion</option>
      <option value="RO">Romania</option>
      <option value="RU">Russia</option>
      <option value="RW">Rwanda</option>
      <option value="GS">S. Georgia and S. Sandwich</option>
      <option value="SH">Saint Helena</option>
      <option value="LC">Saint Lucia</option>
      <option value="MF">Saint Martin</option>
      <option value="PM">Saint Pierre and Miquelon</option>
      <option value="BL">Saint-Barthélemy</option>
      <option value="WS">Samoa</option>
      <option value="SM">San Marino</option>
      <option value="ST">Sao Tomé and Principe</option>
      <option value="SA">Saudi Arabia</option>
      <option value="SN">Senegal</option>
      <option value="RS">Serbia</option>
      <option value="SC">Seychelles</option>
      <option value="SL">Sierra Leone</option>
      <option value="SG">Singapore</option>
      <option value="SX">Sint Maarten</option>
      <option value="SK">Slovakia</option>
      <option value="SI">Slovenia</option>
      <option value="SB">Solomon Islands</option>
      <option value="SO">Somalia</option>
      <option value="ZA">South Africa</option>
      <option value="SS">South Sudan</option>
      <option value="ES">Spain</option>
      <option value="LK">Sri Lanka</option>
      <option value="KN">St. Kitts and Nevis</option>
      <option value="VC">St. Vincent and Grenadines</option>
      <option value="SD">Sudan</option>
      <option value="SR">Suriname</option>
      <option value="SJ">Svalbard and Jan Mayen</option>
      <option value="SZ">Swaziland</option>
      <option value="SE">Sweden</option>
      <option value="CH">Switzerland</option>
      <option value="SY">Syria</option>
      <option value="TW">Taiwan</option>
      <option value="TJ">Tajikistan</option>
      <option value="TZ">Tanzania</option>
      <option value="TH">Thailand</option>
      <option value="TL">Timor-Leste</option>
      <option value="TG">Togo</option>
      <option value="TK">Tokelau</option>
      <option value="TO">Tonga</option>
      <option value="TT">Trinidad and Tobago</option>
      <option value="TN">Tunisia</option>
      <option value="TR">Turkey</option>
      <option value="TM">Turkmenistan</option>
      <option value="TC">Turks and Caicos Is.</option>
      <option value="TV">Tuvalu</option>
      <option value="UG">Uganda</option>
      <option value="UA">Ukraine</option>
      <option value="AE">United Arab Emirates</option>
      <option value="UK" selected>United Kingdom</option>
      <option value="UM">United States Minor Outlying Islands</option>
      <option value="US">United States of America</option>
      <option value="VI">United States Virgin Islands</option>
      <option value="UY">Uruguay</option>
      <option value="UZ">Uzbekistan</option>
      <option value="VU">Vanuatu</option>
      <option value="VA">Vatican City</option>
      <option value="VE">Venezuela</option>
      <option value="VN">Viet Nam</option>
      <option value="VG">Virgin Islands, British</option>
      <option value="WF">Wallis and Futuna</option>
      <option value="EH">Western Sahara</option>
      <option value="YE">Yemen</option>
      <option value="ZM">Zambia</option>
      <option value="ZW">Zimbabwe</option>
    </select>
    <label for="txt_search">
      Enter your postcode or address | Demo API key is limited to "D02 X285" in Ireland, "NR1 1NE" in the UK and "1600 Pennsylvania Ave" in the USA
    </label>
    <div class="search_wrap">
      <input type="text" id="txt_search" value="NR1 1NE" />
      <button type="button" id="btn_search">Find</button>
    </div>
    <div id="address_selection_container"></div>
    <div id="no_result_message">
      Address not found, please enter manually.
    </div>
  </fieldset>

  <label for="txt_organisation">Organisation</label>
  <input type="text" id="txt_organisation" />

  <label for="txt_addressline1">Address</label>
  <input type="text" id="txt_addressline1" />
  <input type="text" id="txt_addressline2" />
  <input type="text" id="txt_addressline3" />

  <label for="txt_posttown">Town</label>
  <input type="text" id="txt_posttown" />

  <label for="txt_postcode">Postcode</label>
  <input type="text" id="txt_postcode" />
</form>

<p>Download the <a href="https://postcoder.com/docs/sample-code/address-lookup" target="_blank">full code example</a> or explore the <a href="https://postcoder.com/docs/address-lookup/address" target="_blank">API reference</a> by <a href="https://postcoder.com" target="_blank">Postcoder</a>.</p>
</p>
              
            
!

CSS

              
                /* Heading style */
h1 {
	font-size: 1.17rem;
}

/* Fieldset for address search inputs */
fieldset {
	background-color: #e5e5e5;
	border: none;
	border-radius: 0.5rem;
	margin: 0;
}

/* Form labels */
label {
	display: block;
	margin-block: 1.25rem 0.25rem;
}

/* General form inputs */
input,
select {
	display: block;
	box-sizing: border-box;
	width: 100%;
	padding: 10px;
	height: 40px;
	margin-block-end: 0.5rem;
	border: solid lightgray 1px;
}

/* Default button styles */
button {
	padding: 0.5rem 1rem;
	border: none;
	background-color: #292929;
	color: #fff;
	font-family: sans-serif;
	font-weight: bold;
}

/* Postcode/address input and button wrapper */
.search_wrap {
	display: flex;
	gap: 0.5rem;
}

/* Postcode/address text input - Remove margin-block-end */
.search_wrap #txt_search {
	margin: 0;
}

/* Address search select container */
#address_selection_container {
	margin-block-start: 0.5rem;
}

/* No address result message */
#no_result_message {
	background-color: #292929;
	color: #fff;
	padding: 0.5rem;
}

/* Set the body tag defaults */
body {
	font-family: sans-serif;
}
              
            
!

JS

              
                class PostcoderAddress {
  constructor(config) {
    this.config = config;
    this.init();
  }

  init = () => {
    this.addresses = {};

    this.searchbutton = document.querySelector(this.config.searchbutton);
    this.searchterminput = document.querySelector(this.config.searchterm);
    this.apiKeyInput = document.querySelector(this.config.apikey);
    this.apiKeyInput.addEventListener("input", this.handleApiKeyInputChange);
    
    this.apikey = this.apiKeyInput.value

    // Hide the no result message
    this.noresultmessage = document.querySelector(this.config.noresultmessage);
    this.noresultmessage.style.display = "none";

    // Create an empty select and place it hidden in the page
    this.select = document.createElement("select");
    this.select.style.display = "none";
    document
      .querySelector(this.config.addressselectioncontainer)
      .appendChild(this.select);

    // Create and append the top 'select an address' option.
    let option = document.createElement("option");
    option.text = "Select an address";
    this.select.appendChild(option);

    // Add select change event listener to the dropdown
    this.select.addEventListener("change", this.handleSelectChange);

    // Add click event listener to the search button, to call the search function
    this.searchbutton.addEventListener("click", this.search);

    // Add 'enter' event listener to the search input, to call the search function
    this.searchterminput.addEventListener("keyup", (event) => {
      if (event.keyCode === 13) {
        event.preventDefault();
        this.search();
      }
    });

    // Determine the number of addresslines required
    this.addresslines = 0;
    for (let i = 1; i <= 4; i++) {
      if (this.config["addressline" + i] !== "") {
        this.addresslines++;
      }
    }
  };

  handleSelectChange = (event) => {
    // Check to see if this selection was to load the next page of results
    if (this.select.value.charAt(0) === "p") {
      // Search the next page of results
      let page = this.select.value.substring(1);
      this.search(event, page);
    } else {
      this.selectAddress(this.select.value);
    }
  };

  updateApiKey = () => {
    this.apikey = this.apiKeyInput.value;
    this.preselectCountry();
  };

  handleApiKeyInputChange = () => {
    this.updateApiKey();
  };

  search = (event, page = 0) => {
    let searchterm = encodeURIComponent(this.searchterminput.value);
    if (this.searchterminput.value.trim().length < 1) {
      console.error("No search term entered.");
      return;
    }

    // Hide the no result message
    this.noresultmessage.style.display = "none";

    // Hide the select
    this.select.style.display = "none";

    // Determine the country; either defined in config
    // or from the dropdown.
    const country =
      typeof this.config.countrycode !== "undefined" &&
      this.config.countrycode !== ""
        ? this.config.countrycode
        : document.querySelector(this.config.country).value;

    // If page 0, remove any previous options
    if (page === 0) {
      while (this.select.options.length > 1) {
        this.select.remove(1);
      }
    } else {
      // Remove the bottom 'next page' option
      this.select.remove(this.select.options.length - 1);
    }

    // Fetch the json formatted result from Postcoder and pass it to processResult
    fetch(
      "https://ws.postcoder.com/pcw/" +
        this.apikey +
        "/address/" +
        country +
        "/" +
        searchterm +
        "?lines=" +
        this.addresslines +
        "&page=" +
        page +
        "&exclude=" +
        (country === "US"
          ? "dependentlocality,posttown,state,stateabbreviation,postcode,country"
          : "organisation,posttown,county,postcode,country")
    )
      .then((response) => {
        if (!response.ok) {
          throw response;
        }
        return response.json();
      })
      .then((json) => {
        this.processResult(json);
      })
      .catch((err) => {
        if (typeof err.text === "function") {
          err.text().then((errorMessage) => {
            console.log(
              "Postcoder request error " + err.status + " : " + errorMessage
            );
          });
        } else {
          console.log(err);
        }
      });
  };

  processResult = (addresses) => {
    this.addresses = addresses;

    // If zero results, ask for manual address entry
    if (addresses.length === 0) {
      // Show the no result message
      this.noresultmessage.style.display = "block";
    }
    // If one result, populate the form
    else if (addresses.length === 1) {
      this.selectAddress(0);
    }
    // Multiple addresses, show drop down to select from
    else {
      // Create and append the address options, using the summaryline of the returned addresses
      for (let i = 0; i < addresses.length; i++) {
        let option = document.createElement("option");
        option.value = i;
        option.text = addresses[i].summaryline;
        this.select.appendChild(option);
      }

      // If there are morevalues, add paging
      if (this.addresses[this.addresses.length - 1]["morevalues"] === "true") {
        // Add a 'load next page' option
        let option = document.createElement("option");
        option.value =
          "p" + this.addresses[this.addresses.length - 1]["nextpage"];

        // Last address contains total number of results, show the user how many are remaining
        let remainingresults =
          this.addresses[this.addresses.length - 1]["totalresults"] -
          this.select.options.length +
          1;

        option.text =
          "Load more results, " +
          remainingresults +
          " of " +
          this.addresses[this.addresses.length - 1]["totalresults"] +
          " remaining";
        this.select.appendChild(option);
      }

      // Ensure the select is visible
      this.select.style.display = "block";
    }
  };

  preselectCountry = () => {
    // Use Postcoder's ipaddress endpoint to pre-select the country list
    if (this.config.geolocate) {
      fetch("https://ws.postcoder.com/pcw/" + this.apikey + "/ipaddress")
        .then((response) => {
          if (!response.ok) {
            throw response;
          }
          return response.json();
        })
        .then((json) => {
          // Make our selection
          document.querySelector(this.config.country).value = json.countrycode;
        })
        .catch((err) => {
          if (typeof err.text === "function") {
            err.text().then((errorMessage) => {
              console.error(
                "Postcoder ipaddress endpoint request error " +
                  err.status +
                  " : " +
                  errorMessage
              );
            });
          } else {
            console.log(err);
          }
        });
    }
  };

  selectAddress = (i) => {
    // Get the selected address
    let address = this.addresses[i];

    let fields = [
      "organisation",
      "addressline1",
      "addressline2",
      "addressline3",
      "addressline4",
      "posttown",
      "county",
      "postcode",
    ];

    // Populate the address form
    for (let i = 0; i < fields.length; i++) {
      let field_selector = this.config[fields[i]];
      if (typeof field_selector !== "undefined" && field_selector !== "") {
        document.querySelector(field_selector).value =
          typeof address[fields[i]] !== "undefined" ? address[fields[i]] : "";
      }
    }
  };
}

new PostcoderAddress({
  apikey: "#apikey",
  geolocate: false, // Automatically pre-select the country select list based on user's IP address; additional credit cost, see https://postcoder.com/docs/address-lookup/ipaddress
  searchterm: "#txt_search", // Query selector of the searchterm input field
  addressselectioncontainer: "#address_selection_container", // Container for the address selection drop down
  noresultmessage: "#no_result_message",
  country: "#txt_country", // Country select list; leave blank if not using a country select list
  countrycode: "", // Hard code if not using a country select list; leave blank otherwise
  searchbutton: "#btn_search",
  organisation: "#txt_organisation", // Leave blank if form does not have a separate organisation field
  addressline1: "#txt_addressline1",
  addressline2: "#txt_addressline2", // Leave blank if form does not have an addressline2
  addressline3: "#txt_addressline3", // Leave blank if form does not have an addressline3
  addressline4: "", // Leave blank if form does not have an addressline4
  county: "", // Leave blank if form does not have a county
  posttown: "#txt_posttown",
  postcode: "#txt_postcode",
});

              
            
!
999px

Console