Samenvatting
Met Blokcode schrijf je de HTML, de opmaak en de JavaScript van één blok. De pop-in heeft daarvoor drie tabbladen, één per soort code.
Dezelfde pop-in gaat op vier plaatsen open. Het bereik van je code verschilt per plaats: van dat ene blok tot elke pagina van je website.
Je opmaak krijgt geen omhullende selector. Schrijf je die er zelf niet omheen, dan raakt je opmaak de hele pagina, en bij een globaal blok je hele website.
Voor deze pop-in heb je het recht Code toegang nodig.
Wanneer gebruik je dit?
Je gebruikt dit wanneer de opties van een blok niet ver genoeg reiken. Denk aan een opbouw die het blok niet kent, of aan gedrag dat je zelf met een script regelt.
Wil je alleen de opmaak van dit blok bijstellen, kijk dan eerst in het instellingenpaneel. Wat je daar kunt kiezen, hoef je niet te schrijven.
Moet je aanpassing op meer dan één blok gelden, dan is dit niet de plek. Kies dan de code van de pagina of van je thema.
Hoe werkt dit in Mach3Blocks?
De pop-in vult je scherm. Bovenin staan de drie tabbladen, in het midden schrijf je, en onderin staan Annuleren en Opslaan.
Welk tabblad je nodig hebt, hangt af van wat je wilt bereiken.
| Tabblad | Waarvoor je het gebruikt |
|---|---|
| HTML | De opbouw van het blok: welke elementen erin staan en hoe zij genest zijn |
| LESS | De opmaak van het blok, met de variabelen van je thema erin |
| JavaScript | Het gedrag van het blok, en het inladen van een meegeleverde bibliotheek |
Het bereik per plaats
Dit is het verschil dat je vooraf moet kennen. Dezelfde pop-in bewaart je code op vier verschillende plekken, en daarmee verandert wat je code raakt.
| Waar je de pop-in opent | Waar je code wordt bewaard | Wat je code raakt |
|---|---|---|
| Een blok op een pagina | Bij dat ene blok op die pagina | Alleen dat blok, op die ene pagina |
| Een globaal blok | Bij het globale blok, één keer | Elke pagina waarop dat globale blok staat |
| Een maatwerkblok | Bij het maatwerkblok | Alleen het maatwerkblok zelf |
| Een blok in een bibliotheek | Bij het bibliotheekblok | Alleen het bibliotheekblok zelf |
Een blok dat je op een pagina zet, krijgt een kopie van de code mee. Werk je het maatwerkblok of het bibliotheekblok daarna bij, dan verandert die kopie niet mee.
Aan het blok zelf zie je niet dat het globaal is. Je ziet het aan de knop met de wereldbol in het blokmenu: die staat dan in de actieve stand. Lees Globale blokken.
Waar je opmaak terechtkomt
| Soort blok | In welke stylesheet je opmaak belandt | Op welke pagina's die opmaak staat |
|---|---|---|
| Een gewoon blok op een pagina | In de stylesheet van die pagina | Alleen op die ene pagina |
| Een globaal blok | In de stylesheet van de hele website | Op elke pagina van die website |
Het platform zet er geen selector omheen. Je opmaak wordt overgenomen zoals je hem hebt getypt.
Wat het opslaan doet
Bij het opslaan controleert het platform je HTML en je opmaak. Is er een fout, dan verschijnt de pop-in Fout in code, met per fout het regelnummer erbij.
Je JavaScript wordt niet gecontroleerd. Een fout daarin komt er zonder melding doorheen.
Het opslaan zet ook de datum van je codewijziging, en het merkt je pagina en je website aan als gewijzigd. Die twee gegevens staan in de pop-in Blok informatie.
Stappenplan
Vier routes, één per plaats waar de pop-in opengaat. De inhoud van de pop-in is overal gelijk.
Een blok op een pagina
- Open de pagina in de editor.
- Klik het blok aan.
- Kies Blokcode in het blokmenu.
- Open het tabblad dat je nodig hebt.
- Typ je code.
- Klik op Opslaan.
- Publiceer je website.
Een globaal blok
- Open een pagina waarop het globale blok staat.
- Klik het blok aan.
- Kies Blokcode in het blokmenu.
- Typ je code.
- Klik op Opslaan.
- Publiceer je website.
Een maatwerkblok
- Kies Maatwerk in het workspacemenu.
- Open het maatwerkblok in de editor.
- Kies Blokcode in de kop van de editor.
- Typ je code.
- Klik op Opslaan.
Een blok in een bibliotheek
- Kies Blokken in het hoofdmenu.
- Open de bibliotheek en daarna het blok.
- Kies Blokcode in de meeropties in de kop van de editor.
- Typ je code.
- Klik op Opslaan.
Voorwaarden en rechten
Je hebt het recht Code toegang nodig. Zonder dat recht staat de knop er niet, en geeft het adres van de pop-in de foutpagina Verboden toegang.
| Waarvoor | Welk recht |
|---|---|
| De pop-in openen en opslaan | Code toegang |
| Het scherm met je maatwerkblokken openen | Code toegang |
| Een blok in een bibliotheek bewerken | Blokken, en daarnaast Code toegang |
| Een blok globaal maken | Websites/presentaties stijlen |
| Je code op je gepubliceerde website zetten | Publiceren |
Gevolgen en beperkingen
Je code hoort bij het blok en reist met dat blok mee. Kopieer je de pagina of de website, dan gaat je code mee in die kopie.
| Gevolg | Wat dat betekent |
|---|---|
| Er is geen omhullende selector | Opmaak zonder eigen selector raakt de hele pagina, of bij een globaal blok je hele website |
| Een globaal blok deelt één stuk code | Je wijziging staat meteen op elke pagina waarop dat blok voorkomt |
| Een geplaatst blok is een kopie | Een wijziging aan het maatwerkblok of het bibliotheekblok werkt daar niet in door |
| JavaScript wordt niet gecontroleerd | Een fout erin levert geen melding op bij het opslaan |
| Eigen HTML kan de opbouw breken | Dat blok is daarna niet meer met de editor te bewerken |
Als het niet lukt
Staat Blokcode niet in het blokmenu, dan mist je gebruiker het benodigde recht. Vraag Code toegang aan bij Mach3Builders.
Verschijnt bij het opslaan de pop-in Fout in code, dan zit er een fout in je HTML of in je opmaak. Herstel de fout, of kies de rode knop Opslaan om je code toch te bewaren.
Werkt je opmaak op plekken waar je hem niet wilt, dan mist je regel een eigen selector. Zet je regels binnen de selector van het blok.
Verandert je blok op een pagina niet mee met je maatwerkblok, dan is dat blok een kopie. Pas het blok op die pagina zelf aan.
Doet je script niets en zie je geen melding, dan is er geen controle geweest. JavaScript wordt bij het opslaan niet getoetst.
Zie je je wijziging niet op je website, dan is die website nog niet opnieuw gepubliceerd.